<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>15.4. Consuming an RSS Feed</title>
<link rel="stylesheet" href="dbstyle.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
<link rel="start" href="index.html" title="Programmer's Reference Guide">
<link rel="up" href="zend.feed.html" title="Chapter 15. Zend_Feed">
<link rel="prev" href="zend.feed.findFeeds.html" title="15.3. Retrieving Feeds from Web Pages">
<link rel="next" href="zend.feed.consuming-atom.html" title="15.5. Consuming an Atom Feed">
<link rel="chapter" href="introduction.html" title="Chapter 1. Introduction to Zend Framework">
<link rel="chapter" href="zend.acl.html" title="Chapter 2. Zend_Acl">
<link rel="chapter" href="zend.auth.html" title="Chapter 3. Zend_Auth">
<link rel="chapter" href="zend.cache.html" title="Chapter 4. Zend_Cache">
<link rel="chapter" href="zend.config.html" title="Chapter 5. Zend_Config">
<link rel="chapter" href="zend.console.getopt.html" title="Chapter 6. Zend_Console_Getopt">
<link rel="chapter" href="zend.controller.html" title="Chapter 7. Zend_Controller">
<link rel="chapter" href="zend.currency.html" title="Chapter 8. Zend_Currency">
<link rel="chapter" href="zend.date.html" title="Chapter 9. Zend_Date">
<link rel="chapter" href="zend.db.html" title="Chapter 10. Zend_Db">
<link rel="chapter" href="zend.debug.html" title="Chapter 11. Zend_Debug">
<link rel="chapter" href="zend.dojo.html" title="Chapter 12. Zend_Dojo">
<link rel="chapter" href="zend.dom.html" title="Chapter 13. Zend_Dom">
<link rel="chapter" href="zend.exception.html" title="Chapter 14. Zend_Exception">
<link rel="chapter" href="zend.feed.html" title="Chapter 15. Zend_Feed">
<link rel="chapter" href="zend.filter.html" title="Chapter 16. Zend_Filter">
<link rel="chapter" href="zend.form.html" title="Chapter 17. Zend_Form">
<link rel="chapter" href="zend.gdata.html" title="Chapter 18. Zend_Gdata">
<link rel="chapter" href="zend.http.html" title="Chapter 19. Zend_Http">
<link rel="chapter" href="zend.infocard.html" title="Chapter 20. Zend_InfoCard">
<link rel="chapter" href="zend.json.html" title="Chapter 21. Zend_Json">
<link rel="chapter" href="zend.layout.html" title="Chapter 22. Zend_Layout">
<link rel="chapter" href="zend.ldap.html" title="Chapter 23. Zend_Ldap">
<link rel="chapter" href="zend.loader.html" title="Chapter 24. Zend_Loader">
<link rel="chapter" href="zend.locale.html" title="Chapter 25. Zend_Locale">
<link rel="chapter" href="zend.log.html" title="Chapter 26. Zend_Log">
<link rel="chapter" href="zend.mail.html" title="Chapter 27. Zend_Mail">
<link rel="chapter" href="zend.measure.html" title="Chapter 28. Zend_Measure">
<link rel="chapter" href="zend.memory.html" title="Chapter 29. Zend_Memory">
<link rel="chapter" href="zend.mime.html" title="Chapter 30. Zend_Mime">
<link rel="chapter" href="zend.openid.html" title="Chapter 31. Zend_OpenId">
<link rel="chapter" href="zend.paginator.html" title="Chapter 32. Zend_Paginator">
<link rel="chapter" href="zend.pdf.html" title="Chapter 33. Zend_Pdf">
<link rel="chapter" href="zend.registry.html" title="Chapter 34. Zend_Registry">
<link rel="chapter" href="zend.rest.html" title="Chapter 35. Zend_Rest">
<link rel="chapter" href="zend.search.lucene.html" title="Chapter 36. Zend_Search_Lucene">
<link rel="chapter" href="zend.server.html" title="Chapter 37. Zend_Server">
<link rel="chapter" href="zend.service.html" title="Chapter 38. Zend_Service">
<link rel="chapter" href="zend.session.html" title="Chapter 39. Zend_Session">
<link rel="chapter" href="zend.soap.html" title="Chapter 40. Zend_Soap">
<link rel="chapter" href="zend.test.html" title="Chapter 41. Zend_Test">
<link rel="chapter" href="zend.text.html" title="Chapter 42. Zend_Text">
<link rel="chapter" href="zend.timesync.html" title="Chapter 43. Zend_TimeSync">
<link rel="chapter" href="zend.translate.html" title="Chapter 44. Zend_Translate">
<link rel="chapter" href="zend.uri.html" title="Chapter 45. Zend_Uri">
<link rel="chapter" href="zend.validate.html" title="Chapter 46. Zend_Validate">
<link rel="chapter" href="zend.version.html" title="Chapter 47. Zend_Version">
<link rel="chapter" href="zend.view.html" title="Chapter 48. Zend_View">
<link rel="chapter" href="zend.xmlrpc.html" title="Chapter 49. Zend_XmlRpc">
<link rel="appendix" href="requirements.html" title="Appendix A. Zend Framework Requirements">
<link rel="appendix" href="coding-standard.html" title="Appendix B. Zend Framework Coding Standard for PHP">
<link rel="appendix" href="copyrights.html" title="Appendix C. Copyright Information">
<link rel="index" href="the.index.html" title="Index">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<div class="navheader"><table width="100%" summary="Navigation header">
<tr><th colspan="3" align="center">15.4. Consuming an RSS Feed</th></tr>
<tr>
<td width="20%" align="left">
<a accesskey="p" href="zend.feed.findFeeds.html">Prev</a> </td>
<th width="60%" align="center">Chapter 15. Zend_Feed</th>
<td width="20%" align="right"> <a accesskey="n" href="zend.feed.consuming-atom.html">Next</a>
</td>
</tr>
</table></div>
<div class="sect1" lang="en">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="zend.feed.consuming-rss"></a>15.4. Consuming an RSS Feed</h2></div></div></div>
<p>
        Reading an RSS feed is as simple as instantiating a <code class="code">Zend_Feed_Rss</code> object with the URL
        of the feed:
    </p>
<pre class="programlisting">&lt;?php
$channel = new Zend_Feed_Rss('http://rss.example.com/channelName');
    </pre>
<p>
        If any errors occur fetching the feed, a <code class="code">Zend_Feed_Exception</code> will be thrown.
    </p>
<p>
        Once you have a feed object, you can access any of the standard RSS "channel" properties directly
        on the object:
    </p>
<pre class="programlisting">&lt;?php
echo $channel-&gt;title();
    </pre>
<p>
        Note the function syntax. <code class="code">Zend_Feed</code> uses a convention of treating properties as XML
        object if they are requested with variable "getter" syntax (<code class="code">$obj-&gt;property</code>) and as
        strings if they are access with method syntax (<code class="code">$obj-&gt;property()</code>). This enables access
        to the full text of any individual node while still allowing full access to all children.
    </p>
<p>
        If channel properties have attributes, they are accessible using PHP's array syntax:
    </p>
<pre class="programlisting">&lt;?php
echo $channel-&gt;category['domain'];
    </pre>
<p>
        Since XML attributes cannot have children, method syntax is not necessary for accessing attribute
        values.
    </p>
<p>
        Most commonly you'll want to loop through the feed and do something with its entries.
        <code class="code">Zend_Feed_Abstract</code> implements PHP's <code class="code">Iterator</code> interface, so printing all
        titles of articles in a channel is just a matter of:
    </p>
<pre class="programlisting">&lt;?php
foreach ($channel as $item) {
    echo $item-&gt;title() . "\n";
}
    </pre>
<p>
        If you are not familiar with RSS, here are the standard elements you can expect to be available in
        an RSS channel and in individual RSS items (entries).
    </p>
<p>
        Required channel elements:
    </p>
<p>
        </p>
<div class="itemizedlist"><ul type="disc">
<li><p><code class="code">title</code> - The name of the channel</p></li>
<li><p><code class="code">link</code> - The URL of the web site corresponding to the channel</p></li>
<li><p><code class="code">description</code> - A sentence or several describing the channel</p></li>
</ul></div>
<p>
    </p>
<p>
        Common optional channel elements:
    </p>
<p>
        </p>
<div class="itemizedlist"><ul type="disc">
<li><p><code class="code">pubDate</code> - The publication date of this set of content, in RFC 822 date
                format</p></li>
<li><p><code class="code">language</code> - The language the channel is written in</p></li>
<li><p><code class="code">category</code> - One or more (specified by multiple tags) categories the
                channel belongs to</p></li>
</ul></div>
<p>
    </p>
<p>
        RSS <code class="code">&lt;item&gt;</code> elements do not have any strictly required elements. However, either
        <code class="code">title</code> or <code class="code">description</code> must be present.
    </p>
<p>
        Common item elements:
    </p>
<p>
        </p>
<div class="itemizedlist"><ul type="disc">
<li><p><code class="code">title</code> - The title of the item</p></li>
<li><p><code class="code">link</code> - The URL of the item</p></li>
<li><p><code class="code">description</code> - A synopsis of the item</p></li>
<li><p><code class="code">author</code> - The author's email address</p></li>
<li><p><code class="code">category</code> - One more more categories that the item belongs to</p></li>
<li><p><code class="code">comments</code> - URL of comments relating to this item</p></li>
<li><p><code class="code">pubDate</code> - The date the item was published, in RFC 822 date format</p></li>
</ul></div>
<p>
    </p>
<p>
        In your code you can always test to see if an element is non-empty with:
    </p>
<pre class="programlisting">&lt;?php
if ($item-&gt;propname()) {
    // ... proceed.
}
    </pre>
<p>
        If you use <code class="code">$item-&gt;propname</code> instead, you will always get an empty object which will
        evaluate to <code class="code">TRUE</code>, so your check will fail.
    </p>
<p>
        For further information, the official RSS 2.0 specification is available at:
        <a href="http://blogs.law.harvard.edu/tech/rss" target="_top">http://blogs.law.harvard.edu/tech/rss</a>
    </p>
</div>
<div class="navfooter"><table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left">
<a accesskey="p" href="zend.feed.findFeeds.html">Prev</a> </td>
<td width="20%" align="center"><a accesskey="u" href="zend.feed.html">Up</a></td>
<td width="40%" align="right"> <a accesskey="n" href="zend.feed.consuming-atom.html">Next</a>
</td>
</tr>
<tr>
<td width="40%" align="left" valign="top">15.3. Retrieving Feeds from Web Pages </td>
<td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td>
<td width="40%" align="right" valign="top"> 15.5. Consuming an Atom Feed</td>
</tr>
</table></div>
<div class="revinfo"></div>
</body>
</html>
